2.3 配置通义千问

通义千问是阿里巴巴推出的中文大模型，在中文理解和生成方面表现优秀。阿里云百炼提供了 Anthropic API 兼容服务，可以方便地在 Claude Code 中接入通义千问系列模型。（https://help.aliyun.com/zh/model-studio/claude-code）

前提条件#

步骤 1：开通阿里云百炼服务#

登录阿里云百炼控制台：https://bailian.console.aliyun.com/
若页面顶部显示需要开通，请点击开通阿里云百炼的模型服务
首次开通后可领取新人免费额度（有效期：90天）
超出额度或期限将产生费用，建议开启"免费额度用完即停"功能

步骤 2：获取 API Key#

进入阿里云百炼控制台
在左侧菜单中找到"API-KEY管理"
点击"创建新的API-KEY"按钮
系统会生成一个 API Key
重要：妥善保存这个密钥，它只会显示一次

安装 Claude Code#

macOS 安装#

在终端中执行以下命令：


bash
npm install -g @anthropic-ai/claude-code

Windows 安装#

在 Windows 上使用 Claude Code，需要先安装 WSL 或 Git for Windows，然后在 WSL 或 Git Bash 中执行：


bash
npm install -g @anthropic-ai/claude-code

配置环境变量#

要通过兼容 Anthropic API 的方式接入阿里云百炼的模型服务，需要配置以下两个环境变量：

ANTHROPIC_BASE_URL：设置为 https://dashscope.aliyuncs.com/apps/anthropic
ANTHROPIC_API_KEY 或 ANTHROPIC_AUTH_TOKEN：设置为阿里云百炼 API Key

macOS 配置#

在终端中执行以下命令，查看默认 Shell 类型：


bash
echo $SHELL

Zsh 配置：


bash
# 用百炼 API Key 替换 YOUR_DASHSCOPE_API_KEY
echo 'export ANTHROPIC_BASE_URL="https://dashscope.aliyuncs.com/apps/anthropic"' >> ~/.zshrc
echo 'export ANTHROPIC_API_KEY="YOUR_DASHSCOPE_API_KEY"' >> ~/.zshrc
source ~/.zshrc

Bash 配置：


bash
# 用百炼 API Key 替换 YOUR_DASHSCOPE_API_KEY
echo 'export ANTHROPIC_BASE_URL="https://dashscope.aliyuncs.com/apps/anthropic"' >> ~/.bash_profile
echo 'export ANTHROPIC_API_KEY="YOUR_DASHSCOPE_API_KEY"' >> ~/.bash_profile
source ~/.bash_profile

打开一个新的终端，执行以下命令验证环境变量：


bash
echo $ANTHROPIC_BASE_URL
echo $ANTHROPIC_API_KEY

Windows 配置#

CMD 配置：


cmd
REM 用百炼 API Key 替换 YOUR_DASHSCOPE_API_KEY
setx ANTHROPIC_API_KEY "YOUR_DASHSCOPE_API_KEY"
setx ANTHROPIC_BASE_URL "https://dashscope.aliyuncs.com/apps/anthropic"

打开新的 CMD 窗口，运行以下命令检查：


cmd
echo %ANTHROPIC_API_KEY%
echo %ANTHROPIC_BASE_URL%

PowerShell 配置：


powershell
# 用百炼 API Key 替换 YOUR_DASHSCOPE_API_KEY
[Environment]::SetEnvironmentVariable("ANTHROPIC_API_KEY", "YOUR_DASHSCOPE_API_KEY", [EnvironmentVariableTarget]::User)
[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://dashscope.aliyuncs.com/apps/anthropic", [EnvironmentVariableTarget]::User)

打开新的 PowerShell 窗口，运行以下命令检查：


powershell
echo $env:ANTHROPIC_API_KEY
echo $env:ANTHROPIC_BASE_URL

支持的模型#

百炼提供的 Anthropic API 兼容服务支持以下通义千问系列模型：

通义千问 Max（仅 qwen3-max-preview 支持思考模式）#

qwen3-max
qwen3-max-2025-09-23
qwen3-max-preview

通义千问 Plus#

qwen-plus
qwen-plus-latest
qwen-plus-2025-09-11

通义千问 Flash#

qwen-flash
qwen-flash-2025-07-28

通义千问 Turbo#

qwen-turbo
qwen-turbo-latest

通义千问 Coder（不支持思考模式）#

qwen3-coder-plus
qwen3-coder-plus-2025-09-23
qwen3-coder-flash

通义千问 VL（不支持思考模式）#

qwen-vl-max
qwen-vl-plus

测试连接#

步骤 1：启动 Claude Code#

在终端中执行：


bash
claude-code

步骤 2：配置模型#

在 Claude Code 对话期间，执行 /mode 命令，然后选择或输入你想使用的通义千问模型名称，例如：


bash
/mode qwen-plus

步骤 3：发送测试消息#

输入一条简单的测试消息：


bash
你好，请用一句话介绍一下你自己。

步骤 4：验证结果#

如果看到通义千问的回复，说明配置成功！

回复应该流畅自然
响应时间应该在几秒内
没有错误提示

模型版本说明#

通义千问 Max 系列#

最强大的版本
qwen3-max-preview 支持思考模式
适合复杂任务和专业场景
价格较高

通义千问 Plus 系列#

能力较强
理解深入
适合大多数复杂任务
价格适中

通义千问 Flash 系列#

响应速度快
成本较低
适合日常对话和简单任务
性价比高

通义千问 Turbo 系列#

响应最快
成本最低
适合快速对话和简单任务
适合新手使用

通义千问 Coder 系列#

专为编程任务优化
代码生成和理解能力强
不支持思考模式
适合开发场景

通义千问 VL 系列#

支持视觉理解
可以处理图像和文本
不支持思考模式
适合多模态任务

重要提示#

旧版接口已弃用：旧版兼容接口 https://dashscope.aliyuncs.com/api/v2/apps/claude-code-proxy 仅支持调用 qwen3-coder-plus 模型，建议迁移至新版接口。
免费额度限制：Claude Code 无法使用 Qwen Code 每日 2000 次免费额度，使用百炼的 API 兼容服务会按照百炼的计费规则计费。
地域限制：本文档仅适用于中国内地版（北京地域）。
思考模式：只有 qwen3-max-preview 支持思考模式，其他模型不支持。

常见问题#

Q：API Key 泄露了怎么办？ A：立即在阿里云百炼控制台删除旧密钥，创建新的密钥，并更新环境变量。

Q：为什么提示"鉴权失败"？ A：检查 API Key 是否正确，注意不要有多余的空格。同时确认 ANTHROPIC_BASE_URL 设置正确。

Q：如何选择合适的模型版本？ A：新手建议使用 qwen-turbo 或 qwen-flash，如果发现能力不足再升级到 qwen-plus 或 qwen3-max。编程任务推荐使用 qwen3-coder-plus。

Q：通义千问和文心一言哪个更好？ A：两个模型都很优秀，建议都配置好，根据具体任务选择使用。通义千问在编程和多模态方面有优势。

Q：如何查看模型参数及计费规则？ A：请访问阿里云百炼控制台的模型列表页面查看详细信息。

Q：环境变量配置后不生效怎么办？ A：确保已执行 source 命令使环境变量生效，并打开新的终端窗口进行测试。

Claude Code 深度教程